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Eesti Background [edit] 
Español 
Hiang Typically, Internet access is asymmetrical, supporting greater download speeds than upload speeds, limiting the 
Português bandwidth of each download, and sometimes enforcing bandwidth caps and periods where systems are not 
Română accessible. This creates inefficiency when many people want to obtain the same set of files from a single source; the 
Pyccknň source must always be online and must have massive outbound bandwidth. The BitTorrent protocol addresses this by 
HX decentralizing the distribution, leveraging the ability of people to network "peer-to-peer", among themselves. 

Sve Each file to be distributed is divided into small information chunks called pieces. Downloading peers achieve rapid 
download speeds by requesting multiple pieces from different computers in the swarm. Once obtained, these pieces 
are usually immediately made available for download by others in the swarm. In this way, the burden on the network is 
spread among the downloaders, rather than concentrating at a central distribution hub or cluster. As long as all the 
pieces are available, peers (downloaders and uploaders) can come and go; no one peer needs to have all the 
chunks, or to even stay connected to the swarm in order for distribution to continue among the other peers. 

A small torrent file is created to represent a file or folder to be shared. The torrent file acts as the key to initiating 
downloading of the actual content. Someone interested in receiving the shared file or folder first obtains the 
corresponding torrent file, either by directly downloading it, or by using a magnet link. The user then opens that file in 
a BitTorrent client, which automates the rest of the process. In order to learn the Internet locations of peers which may 
be sharing pieces, the client connects to the trackers named in the torrent file, and/or achieves a similar result 
through the use of distributed hash tables. Then the client connects directly to the peers in order to request pieces 
and otherwise participate in a swarm. The client may also report progress to trackers, to help the tracker with its peer 
recommendations. 
When the client has all the pieces, it assembles them into a usable form. It may also continue sharing the pieces, 
elevating its status to that of seeder rather than ordinary peer. 
File structure [edit] 
A torrent file is a specially formatted binary file. It always contains a list of files and integrity metadata about all the 
pieces, and optionally contains a list of trackers. 
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A torrent file is a bencoded dictionary with the following keys: 


e announce - the URL of the tracker 
e info - this maps to a dictionary whose keys are dependent on whether one or more files are being shared: 


e name - suggested file/directory name where the file(s) is/are to be saved 

e piece length - number of bytes per piece. This is commonly 28KiB = 256 KiB = 262,144 B. 

e pieces - a hash list. That is, a concatenation of each piece's SHA-1 hash. As SHA-1 returns a 160-bit hash, 
pieces will be a string whose length is a multiple of 160-bits. 

e length - size of the file in bytes (only when one file is being shared) 

e files - a list of dictionaries each corresponding to a file (only when multiple files are being shared). Each 
dictionary has the following keys: 


e path - a list of strings corresponding to subdirectory names, the last of which is the actual file name 
e length - size of the file in bytes. 


All strings must be UTF-8 encoded. 


Extensions [edit] 


A torrent file can also contain additional metadata defined in extensions to the BitTorrent specification. |2] These are 
known as "BitTorrent Enhancement Proposals." Examples of such proposals include metadata for stating who created 
the torrent, and when. 


Draft extensions [edit] 
These extensions are under consideration for standardization. 


Distributed hash tables [edit] 
BEP-0005!5] extends BitTorrent to support distributed hash tables. 


A trackerless torrent dictionary does not have an announce key. Instead, a trackerless torrent has a nodes key: 


{ 
modest e< host <port: |i, mula snOSit= wna <pO lta 


} 
For example, 
"nodes': [["127.0.0.1", 6881]], [["your.router.node", 4804]] 


The specification recommends that nodes "should be set to the K closest nodes in the torrent generating client's 
routing table. Alternatively, the key could be set to a known good node such as one operated by the person 
generating the torrent." 


Multiple trackers [edit] 
BEP-0012/4] extends BitTorrent to support multiple trackers. 


Anew key, announce-1list, is placed in the top-most list (i.e. with announce and info) 


HTTP seeds [edit] 
BEP-0017/5] extends BitTorrent to support HTTP seeds. 


Anew key, httpseeds, is placed in the top-most list (i.e. with announce and info). This key's value is a list of web 
addresses where torrent data can be retrieved: 

{ 

"httpseeds': ['http://www.sitel.com/sourcel.php', 'http://www.site2.com/source2.php'] 


} 


Private torrents [edit] 
BEP-0027[5] extends BitTorrent to support private torrents. 


Anew key, private, is placed in the info dictionary. This key's value is 1 if the torrent is private: 
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{ 
‘private’: 1 


} 


Merkle trees [edit] 


BEP-0030!/] extends BitTorrent to support Merkle trees. The purpose is to reduce the file size of torrent files, which 
reduces the burden on those that serve torrent files. 


A torrent file using Merkle trees does not have a pieces key in the info list. Instead, such a torrent file has a root 
hash key in the info list. This key's value is the root hash of the Merkle hash: 


{ 
sintoni 3 


"root hash': eébdebcc5d55da0a77£4bb1b57d88de7 94838577 


Examples [eit] 


Single file [edit] 


Here is what a de-bencoded torrent file (with piece length 256 KiB = 262144 bytes) for a file debian-503-amd64- 
CD-1.iso (whose size is 647 MiB = 678301696 bytes) might look like: 


"announce': 'http://bttracker.debian.org:6969/announce', 
TIES: 
{ 
‘name': 'debian-503-amd64-CD-1.iso', 
"piece length': 262144, 
‘Length’: 678301696, 
"pieces': '84lae846bc5b6d7bd6e9aa3dd9e551559c82abcl...d14f£1631d776008£83772ee170Cc42411618190a4' 


Note: pieces here would be a 51 KiB value (Ceil(length/ piece length) * 160 = 414080 bits). 


Multiple files [edit] 


Here is what a de-bencoded torrent file (with piece length 256 KiB = 262144 B) for two files, 111.txt and 
222.txt, might look like: 


‘announce': ‘http://tracker.sitel.com/announce', 
SIN EOAR 
{ 

'name': 'directoryName', 

"piece length': 262144, 

'files': 


[ 
T patne: [Pal Sexe 7 Mlength:) ies 
path: 222r EEN Mength: 222) 


] À 
'pieces': '6a8af7eda90ba9f851831073c48ea6b7b7e9feeb. . .8a43d9d965a47£75488d3fb47d2c586337a20b9F' 


See also [edit] 


e Glossary of BitTorrent terms 
e Magnet links 
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